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1 Introduction 



This manual provides installation instructions forth© IMS D7205 OCCam 2 toolset 
for the IBM PC (and compatibles) and the NEC PC. This delivery manual deals 
with PC-specific parts of the toolset. 



1.1 Layout of this manual 

Chapter 1 Introduction: (this chapter) summarises the contents of the release 
and describes its prerequisites. 

Chapter 2 Installing the release: provides installation instnjctions for this re- 
Lease. 

Chapter 3 Confidence testing: contains a simple procedure to check that the 
installation has been done correctly. 

Chapter 4 Building from sources; contains details of how to use the sources 
supplied with the release to rebuild the libraries, server, and makefile generator. 

Chapter 5 Changes from previous releases: contains details of the changes 
from previous versions of the OCCam 2 toolset such as the D705B, 

Appendix A Distribution kit: contains a list of the components of the release. 

Appendix B Debugger function keys: shows the positions of the debugger 
and simulator function keys on the IBM and NEC PC keyboard 



1.2 Prerequisites for running tlie toolset (iBM PC) 

In order to use the OCCam 2 toolset you will require: 

• An IBM PC, PC/XT or PC/AT (or compatible). 

• DOS version 3.0 or later. 

• About 10 Mbytes of free disk space. 

• An IMS B004 or 3008 (or similar) transputer board with an INMOS 32-bJt 
transputer such as an tMS T800 or T414 (Rev B or later), with 2 Mbytes 
or more of memory. 
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Note; for interactive debugging a 32-bit transputer is used to njn the debugger, 
so to use this feature of the toolset at least one additional transputer wilJ be 

needed. 

Afthough not absofutefy necessary, ft is afso strongly recommended that you have 
a version of the make system building tool. Some versions of make compatible 
with the toolset are listed in the user manual, part 1 section 21.1. 



1.3 Prerequisites for running the toolset (NEC PC) 

In order to use the Occam 2 toolset you will require: 
« An NEC PC. 

• DOS version 3,0 or later. 

• About 10 Mbytes of free disk space. 

• An IMS BC10 or B015(orsimilar) transputer board with an INMOS32-blt 
transputer such as an IMS T800 or T414 (Rev B or later), with 2 Mbytes 
or more of memory. 

Note: for interactive debugging a 32-bit transputer is used to run the debugger, 
so to use this feature of the toolset at least one additional transputer will be 
needed. 

Although not absolutely necessary, it is also strongly recommended that you have 
a version of the make system building tool. Some versions of make compatible 
with the toolset are listed in the user manual, part 1 section 21.1. 

1.4 Contents of tfiis release 

The major software and documentation components of the D7205 Occam 2 
toolset release are as follows: 

• A set of 14 360 Kbyte 5.25 Inch floppy disks. 

• A set of 7 720 Kbyte 3.5 inch floppy disks. 

• The Occam 2 toolset delivery manual (this document). 

• The OCCBm 2 toolset user manual -parts 1 and 2. 

• The Occam 2 toolset handbook. 
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• The TDS support guide to aid In upgrading from the TDS. 

• The F editoruser manuaL 

• The Occam 2 reference manual. 

• The Tutoriat introduction to OCCBm programming . 

• The Occam User Group Information. 

• The Occam User Group Enrolment Form, 

• The Occam User Groups. 

• Product registration form. 

A customer checklist is provided listing all components of the refease. 

The toolset provides a collection of tools and libraries to support compilation, 
execution and debugging of Occam 2 programs on transputer networks. The 
facilities provided by the toolset are described in the Occam 2 toolset user 
manual. The Occam 2 toolset fiandbook provides a handy reference guide to 
the tools and libraries. 

A collection of tools and libraries Is provided to aid users in upgrading from 
the INMOS Transputer Development System (TDS) products: IMS D700D and 
D700E. The facilities provided by these tools are described in the TDS support 
guide, it you are not currently a TDS user you can ignore these tools. 

A preliminary version of a folding editor called 'F' is also provided with this toolset. 
This editor is intended primarily for previous users of the TDS who have grown 
used to this style of editing. However, it may be of interest to other toolset users 
who have not yet chosen an editor for use with the toolset. The usage of F is 
described in the F editor user manual. 

Additional copies of the toolset user manual can be ordered; the product number 
is IMS D0205. 

1.5 Compatibility with previous releases 

This release is not object compatible with previous INMOS occam products 
such as the D705B; it uses a new object format known as TCOFF (Transputer 
Common Object File Format). Source files should be recompiled with the new 
tools. Chapter 5 of this delivery manual describes the main changes in the 
source languages acceptad by this toolset, over the D705B. 
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For circumstances where it is not possible to recompile source, there is a conver- 
sion tool called icvlink which may be used to convert object files produced by 
the D705B (LFF format) to object files suitable for use with this toolset, icvlink 
is described in the user manual, part 1, chapter 13. 

For users of the TDS, the TDS source file structures must be converted so that 
they are suitable for compilation with the toolset. See the TDS support guide for 
details. 

This release is compatible with the D7214 ANSI C toolset supplied by INMOS, 
which also uses the TCOFF object format. Together these toolsets can be used 
for mixed language programming in C and OCCam. 



1.6 Notes for users of the D7214 ANSI C toolset 

The D7205 Occam toolset and the 07214 ANSI C toolset have some tools in 
common, such as the linker, librarian and debugger. The installation procedures 
for the D7205 create a totally separate directory structure for the Occam tools. 
However, for users of both toolsets^ it is necessary to know which revision of the 
tool to choose. 

When choosing which version of a tool to use always use the fater version. Tools 
are designed to be backwards-compatible so that they will work with previous 
releases of the TCOFF toolsets. A tool will not necessarily work in conjunction 
with tools from a later toolset; for example the debugger supplied with the ANSI 
C toolset will not necessarily support Occam. 

Consult the release notes to determine which revisions of the ANSI C toolset this 
release post-dates. If you are using both toolsets, put the later release on your 
path before the earlier one. if you decide to combine the tools into a common 
directory, then, for tools which are in both toolsets, always use the later one. 

If you are mixing Occam and C, informalion is provided in both the ANSI C 
toolset user manual and the occam toolset user manual. The ANSI C toolset 
manual describes how to call OCCam from a C program or from the C config- 
uration language. The OCCam toolset manual describes how to call C from an 
Occam program. 
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2 Installing the release 



This release of the IMS D7205 Occam 2 toolset comes on 14 360K 5.25 inch 
floppy disks and on 7 720K 3.5 inch floppy disks. You will require about 10 
Mbytes of free space to install the entire release. 

The whole release will be installed by the installation procedure, to make the 
process as easy as possible. You can delete some of the components after 
installation if you wtsh. 



2.1 Installation 

To install the release first insert Disk 1 in your floppy disk drive. Next run the 
batch file, install.bat, on Disk 1, giving as parameters the drive letter of 
the floppy disk drive and the drive on which the toolset will be installed. 

For example, if your floppy disk drive is A, and the drive on which you want the 
toolset installed is C, type: 

a: install a c 

You will then be given instructions to put each disk in turn into the floppy disk 
drive. The contents of each floppy disk will be copied onto the destination 
drive. The Installation procedure will then extract the fites of the toolset from 
the archives and place them in appropriate directories. 

If the installation has been successful the following messages will be displayed 
at the end of installation: 

INSTALIiATION COMPLETE 



The installation procedure creates a directory called \d7205. All the programs 
necessary to install the toolset are copied to this directory. All the components 
of the toolset itself are copied into sub-directories of \d7205, as shown in the 
following table: 
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Directory 


Contents 


\d7205\itool3 


The transputer-hosted tools. 


\d7205\tools 


The PC-hosted tools. 


\d7205\libs 


The toolset libraries and in- 




clude files. 


\d7205\iterms 


Example ITERM files. 


\d7205\examples 


Examples directory. 


\d7205\examples\bootstrp 


Bootstrap example sources. 


\d7205\examples\idebug 


Debugger example sources. 


\d7205\examples\mixed 


Mixed language example 




sources. 


\d7205\examples\rRixconf 


Mixed language configuration 




example sources. 


\d7205\examples\oc 


Occam compiler example 




sources. 


\d7205\examples\occonf 


Configurer example sources. 


\d7205\examples\sorter 


Sorter example sources. 


\d7205\iserver 


The iserver executablGS. 


\d7205\source 


Source code. 


\d7205\source\iserver 


Server sources. 


\d7205\source\imakef 


Makefile generator sources. 


\d7205\source\driver 


Driver sources. 


\d7205\source\iibs 


Library sources(in sub directo- 
ries). 
The TDS to toolset conversion 


\d7205\tdstools 




utilities. 


\d7205\f 


The F folding editor 


\d7205\install 


Installation scripts. 



Appendix A describes these directories and their files in more detail. 

The release installation procedure installs everything onto the hard disk. Certain 
parts of the toolset release may be removed from the hard disk if disk space is 
a problenn. The following table indicates which parts of the release are essential 
for its correct operation. 
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Component 


Necessary 


itools 


yes 


tools 


yest 


libs 


yes 


iterms 


yes 


iserver 


yes 


source 


no 


examples 


no 


tdstools 


no 


f 


no 



t Some of the tools are provided in both PC-hosted and transputer-hosted ver- 
sions. 

PC-hosted versions are ones which mn on the PC. Transputer-hosted versions 
run on the transputer board. For each transputer-hosted tool there is a 'bootable 
file' with the extension .btl which contains the code to mn on the transputer, 
and a driver program, with the extension . exe which runs on the PC. By typing 
the name of the tool, the driver program is invoked, and the transputer version 
of the tool is loaded and run on the transputer. 

In general the PC-hosted ones will be faster to start up, as the transputer-hosted 
ones have first to be loaded onto the transputer board. However, the transputer- 
hosted ones can use the full memory available on the transputer board, and 
therefore can be used to build larger systems than the tools limited by the mem- 
ory model on the PC. So in general you should use the PC-hosted tools in 
preference to start with, but move to the transputer-hosted versions if you en- 
counter memory problems. If you are happy to use just the transputer-based 
tools then the tools directory may be deleted. 

Do NOT delete the itools directory as it contains some tools for which hosted 
equivalents do not exist. Some tools, such as the debugger idebug and the 
dump tool idump were designed to work only on the transputer. Other tools, 
such as the Occam compiler oc and the configurer occonf cannot run hosted 
on the PC because of the memory limitations of the PC. 

If you are not upgrading from the TDS (Transputer Development System) then 
you will not need the tdstools directory, and this may be deleted. 

If you do not require the F folding editor, then the f directory may be deleted. 

The source and examples directories are not strictly needed for the operation 
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of the tooJset, but It is recommended that you leave thenn installed, at least 
initially, as they provide many useful examples of OCCam programs, some of 
which are referred to in the manual. 

Having installed the toolset you have to set up some environment variables before 

you can use any of the tools. The setup process Is described in the next section. 



2.2 Setting up the toolset for use 

This section explains how to set up the environment necessary to use the toolset. 
It describes the basic changes to the system configuration file config.sya 
which you should make before you attempt to use the toolset and shows how to 
set up the necessary environment variables. 



2.2.1 Choosing an iserver for use 

All tools which run on the transputer are loaded by a program running on the PC 
known as the iserver. As well as loading the program it supplies access to 
the PC's terminal and file system. User programs are also loaded and served 
by the iserver. 

Three compiled versions of the iserver are provided in the toolset release, in 
the directory \d7205\i3erver. One of these must be chosen for use with 
your toolset. The three versions are as follows: 

isvrb04 , exe For the IBM PC with an IMS B004 or BOOS board or 
equivalent. 
^ isvrbOS . exe For the IBM PC with an IMS BOOS board and device driver, 
isvrnec.exe For the NEC PC with an IMS B010 or B015 board. 

Note that the IMS BOOS version of iserver should only be used if you have 
installed the IMS B008 device driver in the IMS S708 (which is the BOOS software 
support product). Otherwise use the IMS B004 server isvrb04 .exe. 

To set up the appropriate iserver for use copy the selected server into the fiie 
iserver.exe; for example, to select the B004 server isvrb04.exe: 

cd \d7205\iserver 

copy isvrb04,exe iserver. exe 
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2.2.2 Sening the FILES variable 

The FILES command in your system configuration file conf ig . ays should be 
changed or added to specify at least 20 simultaneously open files. For example: 

FILES-20 

Note: Any other file handling software used on the system (such as PC-NFS) 
should also be reset to accept at least 20 simultaneously open files. 



2.2.3 Setting the correct path 

You should add the DOS commands given below to your autoexec .bat file 
so that they will be set up whenevsr you switch on your PC. 

If you wish to use the transputer based tools then only add the directories 
\d7205\i3erver and \d7205\itools to your DOS path. To do this use 
the DOS path command. 

If hosted tods are required add \d7205\tools before \d7205\itools. 

For example to set your path to your system commands and then the toolset (on 
drive C), type: 

PATH=C:\DOS;C:\D7205\ISERVER; C:\D7205\ITOOLS 

The above command sets up the path to find the transputer based tools only. 

2.2.4 Setting an alternative iserver 

The transputer- hosted tools are started by a driver program which runs the 
iserver to load the appropriate tool and run it on the transputer board. A 
copy of this driver exists for each of the transputer-hosted tools. 

It is possible to arrange for the driver to pick up a different version of iserver 
from that on the path. An alternative iserver can be used by defining the file 
to be used in the ISERVER environment variable. If the iserver environment 
variable is defined on the system then the iserver is referenced by the en- 
vironment variable rather than from the DOS path. If iserver is not defined 
on the system, then the DOS path, set up using the path command, is used to 
find the server. 

For example: 
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To use a server called myserver.exe from your \bin directory on drive C, 
use the following definition; 

set ISERVER=C:\BIN\MYSERVER-EXE 

2.2.5 Using the TDS conversion tools and F editor 

The TDS conversion tools and F editor are contained within their own directory 
stnjclures for easy deletion by users who do not require them. Each of these di- 
rectories contains a tools and itools subdirectory containing the PC-hosted 
and transputer-hosted versions of the tools respectively. 

To make use of these tools you can do one of the following: 

• Copy the tools into the \d7205\tools and \d7205\itoolg direc- 
tories as appropriate; these wiil then be picked up from the DOS path. 

• Include the appropriate \d7205\tdstools and \d7205\f subdirec- 
tories in your PATH definition. 



2.2.6 Setting the board memory size 

Before you can use any tool or user program which runs on your transputer 
evaluation board you must set up an environment variable, IBOARDSI^E, giving 
the size of the memory on the board (in bytes). To do this use the DOS set 
command. For example, to set a board size to 2 Mbytes type: 

set IBOARDSIZE=#200000 

You may give either a decimal or hexadecimal (preceded by '#') number. On 
keyboards without '#', the '$' character can be used instead. Leading and trailing 
spaces are prohibited. 

It IBOARDSIZE is specified incorrectly, for example as a character, string or 
with leading or trailing spaces, the system defaults to a board size of (zero) 
and it is not possible to run a program, if iboardsize is explicitly set to a very 
small value a similar error may occur. 

Note: that setting very small board sizes may cause some tools to hang. This is 
an important point to remember when developing programs for 1 6-bit transputers 
such as the T222. Remember to reset the boardsize after testing the 16-bit 
transputer program as some of the tools will hang if njn with a small value of 

IBOARDSIZE. 
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2*2.7 Setting a file system search path 

To enable tiie tools to find libraries and include files you must set up an envi- 
ronment variable called isearch. This environment variable normally contains 
the standard library and Include file directory (\d7205\libs\), together with 
any user directories as required 

Note: that unlike the DOS path you must add the closing backslash, \, to a 
directory name. 

Directories may be separated by a space or a semi-colon. For example to set 
up ISEARCH to point to the standard include files and libraries and to a user 
directory called \mydir type the following DOS command: 

set ISEARCH=C:\D7205\LIBS\;C:\MYDIR\ 



2.2.8 Setting root memory size for idebug 

The amount of memory on the root transputer must be defined for idebug, using 
the environment variable idebugSIZe. This variable is set up in the same way 
as IBOARDSIZE (see section 2.2.6) and should be set to the available memory. 
Leading and trailing spaces are prohibited. 

The debugger requires at least 1 Mbyte of memory on the root transputer to 
operate correctly, but 2 Mbytes or more is recommended. 



2.2.9 Setting an alternative board address 

The default PC bus address used by the iserver for locating the transputer 
board is #150 for the IBM PC and #DOforthe NEC PC. If your transputer board 
resides at a different address in the PC bus you shouid set up the environment 
variable TRANSPUTER which gives the address of the board. The address must 
be given in hexadecimal. 

For example, if your transputer board is at address #200, use the following 

command: 

set TRANSPUTER=200 

You can aiso use the iserver 'SL' option to override the address specified by 
the TR3VNSPUTER environment variable. 
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2.2.10 ITERM support for the debugger and simulator 

The interactive debugger idebug and Ihe simulator isim drive the PC screen, 
and Inave a set of PC function keys which are used for user input. These pro- 
grams are portable to a variety of terminals, and use a terminal setup file, known 
as "ITERM" to determine the screen and keyboard characteristics. This section 
describes how to set up the ITERM tor the IBM PC. If you are using a NEC PC 
then read the next section instead. 

In order to use the debugger or simulator you will need to use a screen de- 
vice driver that can recognise ANSI escape sequences. You should use either 
ansi . sys which is supplied with DOS, or bans! . sys which Is supplied with 
this toolset release. 

The normal ansi. sys supplied with a PC does not support features such as 
insert line and delete line. Without such features, the debugger has to redraw 
the whole screen whenever it scrolls. In order to overcome such limitations this 
release includes a replacement for ansi . sys which is known as bansi . sys. 
This is compatible with ansi , sys; it merely provides extra functionality. 

Once installed it may be used with tools other than the debugger or simulator 
(for example, with the F folding editor). 

In order to install bansi. sys you will need to place the following in your 
config.sys file (if you prefer to install ansi. sys you must add the ap- 
propriate DEVICE line for it) ;- 

DEVICE=C : \D7205\ITERMS\BANSI . SYS 

This line should replace a similar line that references ansi. sys (if it was 

present). 

You will need to re-boot the PC in order for the bansi . sys device driver to be 
used. 

You should then set your ITERM to use pcbansi.itm if you have installed 
bansi . sys and pcansi . itm tf you have installed ansi . sys. 

set ITERM=C: \D7205\ITERWS\PCBANSI. ITM 

The keyboard assignment created by this ITERM is shown in Appendix B. 
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2.2.11 ITERM on the NEC PC 

If you are using a NEC PC computer then you must set your iterm environment 
variable to use necansi . Ititi. 

For example: 

set ITERM=C: \D7205\ITERMS\NECANSI . ITM 

The keyboard assignment created by this ITERM Is shown in Appendix B. Forthe 
NEC PC a simple keyboard assignment has been chosen, which does not make 
any use of the function keys. Use of the function keys requires the keyboard to 
be initialised. The keyboard assignment provided will allow NEC PC users to get 
started with the minimum of complication. You can develop a more sophisticated 
ITERM using the function keys if you wish. 

2.2.12 Summary of setup process 

Here is a summary of the setup steps needed before the toolset may be used: 

1 Set up an appropriate iserver for your PC and board type. 

2 Set up the files variable in conf ig . sys. 

3 Set up the path variable. 

4 Set up the ISERVER environment variable, if desired. 

5 Set up the iboaeudsize and idebugsize environment variables. 

6 Set up the ISEARCH environment variable. 

7 Set up the TRANSPUTER environment variable, if required. 

8 Install BANSI . SYS, if required. 

9 Set up the ITERM environment variable, 

The environment variable commands should be placed in autoexec.bat so 
that they are set up every time the PC is switched on. 

It may be necessary to increase the amount of environment space available; the 
next section describes how to do this. 
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2.3 Environment space 

The PC may not have enough environment space by default. This may need to 
be increased in order to ain the toolset. 

All versions of DOS aiiow the environment space to be increased to a maximum 
of 32 Kbytes, with varying degrees of difficuity. For the commands or procedures 
to use on your system consult the user documentation for the specific version of 
DOS you are using. 

For DOS versions 3.2 and later the shell command in the conf ig.ays file 
can be used to set up an environment size when the PC is booted. For example: 

SHELL=COMMAND.COM /E:1024 /P 

This example gives the name of the DOS command processor, sets the envi- 
ronment space to 1024 bytes and makes this version of the command processor 
permanently resident. 

In DOS version 3.3 and later the command calied command can be used to 
increase the environment space. For example: 

COMMAND /E:1024 /P 

This has a similar effect to the shell command example but is invoked from 
the DOS command line. 

Earlier versions of DOS require the command processor (command . com) to be 
patched. Microsoft provide a utility setenv that will do this automatically. 



2.4 Using the F editor 

if you wish to use the F editor you will need to set up some environment variables 
and some host-specific absolute file names. These are discussed both in the 
read. me file included with the software and in the F editor manual. 

The environment variables are FTERM which must reference an appropriate ex- 
tended ITERM file for the host keyboard and screen you are using and, optionally, 
FSTART which may be used to override the pointer to the F start up file which 
is found in the F section of the ITERM file. 

The supporting files required by the F editor are the following: 
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An ITERM file pcfold.itm 

A keyboard help file pcfoid.hlp 

A startup file f old. stp 

A command file fold.cmd 

These are supplied in the directory \d7205\f \data. 

The ITERf\4 file must be identified by the fterm environment variable. The 
keyboard help file is by default in a file with the same root name as the ITERM, 
but with the suffix .hip. The startup file is identified by a line in the ITERM file 
or by the fstart environment variable. The choice between these depends on 
the extent to which the same file is to be shared between different users* or the 
same user using different directories or different terminals. The command file is 
identified by a line in the startup file. The choice between an absolute or local 
file name for this is left to the user. See the F User Guide. 

As an initial confidence test of the installation of F, go to a directory contain- 
ing the ITERM file appropriate to your environment and call the F editor to 
edit this file. If you are new to folding you may like to edit the F tutorial file 
(\d7205\f\data\ftutor.occ), which will guide you through the facilities 
offered by the editor. 

For the NEC PC a batch file called necf ,bat can be run to start up the editor. 
This sends a file to the terminal to initialise the function keys. This file needs to 
be adapted to work correctly with the latest versions of DOS for the NEC PC. 



2.5 Server interrupts 

It is possible to interrupt the iserver, go to DOS to Issue DOS commands, 
and subsequently return to the server. This has the effect of temporarily halting 
the server. The program on the transputer continues to run until access to the 

server is required. 

To interrupt the server, use the following procedure. Remember to enable the 
BREAK key first using the DOS break command. 

Use CTRL-BREAK (in preference to CTRL-C) in order to interrupt the program. 
A prompt will appear. Type 'S' at the prompt, which enters a new DOS command 
processor. DOS commands can now be executed as necessary. 

In order to return to the server type exit. This quits the DOS command pro- 
cessor and restarts the iserver. 

When in DOS do not invoke any tool or program that runs on the transputer 
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board, or the program running in the background will be corrupted. 

The ability to Internjpt the server relies on the existence of either a DOS envi- 
ronment variable COMSPEC or a DOS command file command . com In order to 
recall DOS. 

The user manual refers to the "host break key". For the PC toolset products this 
is CTRL-BREAK. 



2.6 Driver program errors 

The transputer based tools are executed through a driver program which itself 
generates error messages. For example: 

Fatal-driver- unable to execute ^oc' , Arg list too long 

In this example the messages indicates that the DOS limit on the length of the 
command line has been exceeded. 

Driver errors are generated for limitations or errors such as a command line too 
long, denial of read/write access to a file, and file or directory not found. 



2.7 Transputer error flag 

The driver programs for the transputer hosted tools (except idebug and idump) 
monitor the error flag as the tool executes in order to catch any internal errors 
o1 the tool should they occur. If your hardware Is configured as a Down system 
and consists of more than one transputer, the driver programs may be fooled 
into thinking the tool has set the error flag If the error flag on one of the extra 
processors is already set when the tool is executed. In order to overcome this 
problem, you should run a network check program, such as ispy, or boot a 
(dummy) program that uses all of the processors in the networi^. 

The ispy program is provided as part of the board support software for INMOS 
yq systems products. These products are available separately through your local 
INMOS distributor. 

Note: that once cleared, an error flag on a transputer will only become set again 
if you execute an erroneous program on the transputer or you power on the 

transputer again. 
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This chapter describes a short procedure which may be followed to check that 
installation has been done correctly. 

1 Set the current disk to the same disk as the toolset has been installed on. 
For example, it the compiler has been Installed in directory C:\D7205, 
do this: 

D>c: 

C> 

2 Set the current directory to a convenient directory for doing this test. For 
example: 

Ocd \mine 

C> 

3 Copy the example simple, occ file to the current directory: 

Ocopy \d7205\examples\oc\siiople.occ 
1 File(s} copied 

C> 

4 Use imakef to build a makefile which will build you a bootable file in /ta 
mode (this produces a version which will run on any 32-bit transputer): 

C>iinakef simple. bah 

C> 

If, instead of the C> prompt the computer outputs the lollowing, or some- 
thing similar — 

Error - iserver - protocol error , , , 

— it is likely that there has been some error in setting up the transputer 
board. In particular, please check that the wire links, accessible from the 
back of the PC, have been correctly installed. The transputer board's 
documentation should help with this. 

It may also be necessary to change the default address at which the 
transputer is assumed to be in the PC's bus as the compiler plus the 
other tools are loaded at the address #150. For example, if your trans- 
puter board is at address #200 then it will be necessary to add the 
option 7sl 200' to the command line when running the tools (or set 
the environment variable transputer to 200). 
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5 Now use a suitable make tool to build the example program. Details of 
which make tools are suitable can be found in the occam 2 Toolset 
User manual. If you don't have a suitable make tool at present you 
should simply type the lines below starting oc, ilink and icollect. 

Omake -f simple, mak 

oc simple /ta /h /o simple. tah 

ilink /f simple. lah /ta /h /o simple. cah 

icollect simple. cah /t /o simple. bah 

C> 

6 Finally, the program can be run: 

Oiserver /sb simple. bah 
Please type your name : Bruce 
Hello Bruce 

C> 

The output 'Hello Bruce' comes from the simple. occ example program 

and the name you type in. 
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The Occam 2 toolset is supplied with the source o# some of the libraries, the 
makefiie generator, the server and the driver program. This chapter gives advice 
on how to rebuild the binaries. 

The sources are supplied in subdirectories of \d7205\source. 

4.1 The driver program ' '^^ ''^'^ ^^ ^' ' ^^ >^ir.t^ - 1 ^^A^^ 

The driver program (see section 2.1) is supplied as a single C source file called 
driver, c. This can be recompiled using Microsoft C version 6.0. 



4.2 The Makefile generator 

The makefile generator program imakef is supplied as a collection of C source 
files and two makefiles. The makefile makefile. pc compiles imakef for the 
the PC and requires Microsoft C version 5.0 or later. To recompile type: 

Omake -f makefile. pc 
C> 

The makefile makef ile . tp compiles imakef for the transputer and requires 
the INlMOS ANSI C toolset (IMS D7214). To recompile type: 

C>make -f makefile. tp 
C> 

4.3 The server 

The iserver source is supplied as a collection of C source files and a collection 
of makefiles which compile the iserver for the appropriate host. 

The makefile makefile. pc compiles iserver for the PC and requires Mi- 
crosoft C version 5.0. To recompile type: 

Omake -f makefile, pc 

C> oWsg^^\i^X! 

The sources exist for building the file server to communicate with the following 
transputer board products: 
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IMS B004 (INMOS Ltd) 

IMS BOOa (INMOS Ltd) 

IMSB010 (INMOS Ltd) 

IMSB011 (INMOS Ltd) 

IMS BOH (INMOS Ltd) 

IMSB015 (INMOS Ltd) 

IMSB016 (INMOS Ltd) 

C3 QTO (Caplin Cybernetics Corp.) 

Makefiles are supplied for building the iserver for all the different board types 
supported. Source for using the file server under the Helios operating system 
(Perihelion Software Ltd) is also included. 

4.4 The libraries 

The libraries are more complicated to rebuild. If you wish to rebuild or customise 
the libraries the following information will be of use. It assumes that you are 
experienced in the use of the toolset. 

To determine which routines in which error mode and for which transputer types 
are in a library, study the output of ilist on the library in question, e.g. ilist 
string, lib /e. This will also show whether the sources were compiled with 
the Y option or not. All supplied libraries are built compiled with minimum debug 
data included ( the D option on oc ). The maths libraries snglmath.lib. 
dblmath.lib and -tbmaths .lib are built with vector space and njn-time 
checks disabled (the v and u options on oc ). 

This is, in general, enough information to rebuild a library. However, one compli- 
cation arises. In some libraries, hostio . lib for example, some of the routines 
use other routines in the same library. In such a case the more primitive rou- 
tines must be compiled first and made into a ( temporary ) library which the other 
routines then #USE in order to access them. Finally, once all the library compo- 
nents have been successfully compiled, the whole library can be built, and the 
temporary library can be deleted. 

The libraries which are built in the manner described above are hostio, lib, 
tbmaths , lib, and convert . lib. To rebuild one of these libraries you need 
to proceed as follows. Examine the source code of the library routines; if you see 
the #USE of a library with an unknown name, it is one of these temporary libraries 
( e.g. utilstb.lib in tbmaths. lib sources ). By looking through the 
sources of the routines using this library, you can determine its required contents. 
Constnjct an appropriate . Ibb file to make the temporary library. Then compile 
the appropriate routines and combine them into a library using ilibr. You 
can then compile all the routines which depend on this library. Proceed until 
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everything has been compiled successfully, and then ilibr everything together 
to make the desired library. 

Note: that some whole libraries depend upon others (e.g. hostio.lib de- 
pends on convert, lib). Therefore if you rebuild convert. lib, you will 
also need to rebuild hosticlib. The Miu' files for the libraries list the 
dependencies. 
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5 Changes from previous 
releases 



The D7205 Occam 2 toolset is a new set of OCCam tools, giving a consid- 
erable Improvement over the D705B toolset release. A summary of the major 
improvements is provided beiow: 

• The toolset is compatible with the INMOS ANSI C toolset release (IMS 
07214). 

• The facilities for mixing C and OCcam have been improved. As well as 
the ways of calJing C processes from OCCam supported in the D705B, 
a number of additional procedures are available which allow calling of C 
functions directly. Even tunctions making use of static variables can be 
called. 

• Multiple error detection is now done by the OCcam compiler rather than 
by a separate tool (icheck). 

• Interaciive debugging on the target network is now supported, including 
the setting of breakpoints, and the ability to examine and modify the state 
of processes. 

« There is an improved configuration language, supporting separate de- 
scriptions of hardware and software, and automatic placement of chan- 
nels on links. 

• Procedures and functions can now be defined as inline, causing the 
compiler to insert code inline at a call. 

• There is a new form of assembler insert. Introduced by the keywond ASM, 
which provides better facilities than the old GUY keyword. The GUY fomi 
of insert has been retained in this release for compatibility. 

• Tools for creating EPROM program files are now included in the toolset. 

» A folding editor called T' is included in the package. 

The object file format has been changed since the previous release; the tools 
now support an object file format called TCOFF (Transputer Common Object 
File Format) which is becoming a standard across all INMOS toolsets. A con- 
version tool called icvlink is provided to convert old format object files into 
the new format, but to use the new features of the toolset existing code should 
be recompiled into the new format. 
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5.1 Adaptations required to existing program source 

The Occam programming language implemented by the toolset is essentially 
the same as that implemented by the D705B, with a number of extensions. The 
main change is in the configuration language. 

The changes required to configuration programs include: 

• Preparing a separate description of the hardware, including the atlocation 
of names to processors in the networl<. 

• Declaring the host connection, from which the network is booted, and 
placing channels on that link. 

• Altering the placed par to refer to the processor names rather than al- 
iocating them numbers and types, and removing all of the channel place- 
ments on link numbers (which can now be determined automatically by 
the configurer). If the specific placement of a channel on a link is needed, 
the link must be given a name in the hardware description; that name 
can then be used in a place statement In the software description. 

• Combining the hardware and software descriptions in a file, with the ap- 
propriate keywords to distinguish them. 

There are many changes in the compiJalion and configuration tools, which have 
been re-designed and re-implemented since the D705B. The tools have a greater 
number of options, to allow more flexibility and control over the code being gen- 
erated. The creation of bootable files for processor networks is done in two 
stages, using the tools occonf and icollect. The icollect tool is also 
used in place of iboot to create a bootable program for a single processor. 

The debugger idebug has been extended to support interactive debugging of 
programs in a network. This requires changes in the code generated by the 
compilation tools. Interactive debugging code is produced by default; the tool 
option Y is available on a number of tools to suppress the generation of interactive 
debugging support, and generate more efficient code. 

In spite of these changes, the structure of source files which go to make up an 
Occam program fs similar to that of the D705B. Once the required changes have 
been made to the configuration source, the imakef tool can be used to gener- 
ate a make file containing all the tool invocations required to build the bootable 
file. The file extension conventions of imakef are the same as in the D705B, 
although the tools themselves do not specifically require these conventions. Run- 
ning the resultant make fife may rndicate a number of small changes required to 
the source files, which it should be possible to resolve from information available 
in the user manual. 
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5.1.1 Changes in the implementation of occaiTi 

There are a number of changes in the implementation of Occam. These are 
described in this section. 



5.1.2 Changed implementation of channels 

PLEASE READ THIS SECTION CAREFULLY. IF YOU THINK THIS APPLIES 
TO YOU PLEASE READ THE APPROPRIATE SECTION OF THE USER MAN- 
UAL BEFORE ATTEMPTING TO COMPILE AND RUN OCCaiTi PROGRAMS 
WITH THIS TOOLSET. 

The low level behaviour of channels has changed since the previous OCCam 
toolset release. This will not aifect programmers working entirely in occarti. 
However, programmers using GUY and ASM code, and PLACEing channels, 
must be aware of the change. For example, programs containing an array of 
channels placed on the transputer links must be changed. The change may also 
affect programmers using kernel, run and its associated predefines. 

The changes are described in section 10.1.3 of the Low level programming 

chapter of the user manual. The ability to manipulate channels has been re- 
moved from the GUY assembly faciiity, to ensure that code manipulating channels 
Is recoded in asm. 



5.1.3 UNDEFINED and UNiVERSAL error modes 

The error mode, and the type of errors which are detected, have now been de- 
coupied. Thus you can now run in HALT mode, but turn off most checks, etc, 
and it is possible to write code which will execute in either HALT or STOP mode, 
but still correctly trap errors. 

UNDEFINED error mode is no longer supported, it can be mimicked by using 
the u command line switch, which turns off the insertion of any run-time error 
checks. Hence a program compiled in HALT mode, but with this command line 
flag, will behave as if in OCCam UNDEFINED error mode. 

UNIVERSAL error mode has changed its behaviour. It now is compiled to behave 
exactly like HALT or STOP error mode, according to whether the transputer's 
HaltOnError flag is set. It does not turn off all error checks like it did in the 
past. To do this, you should also add the o command line switch. Thus x and 
U together now mimic the old UNiVERSAL mode. 

The system of error modes is described in detail in the user manual. 
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5.1.4 Transputer types 

The support for transputer types and classes has been extended to incorporate 
new transputer types introduced since the D705B, It has also changed its imple- 
mentation to allow more flexible creation of libraries, and to allow the creation 
ot programs which are guaranteed to run on a range of transputer types. The 
main difference for existing programs is that ta code can no longer be called 
from TB code, as the method used to return floating point results from functions 
differs between the classes. There is no longer a TC class. 

The system of transputer types is described in detail in the user manual. 



5.1.5 #SC directive 

The #SC compiler directive is no longer supported. 

5.1.6 Stricter checking of fri par 

The compiler does stricter checking of nested PRI par constructs* including 
checks across separate compilation boundaries, to enforce the OCCam njle that 
a PRI PAR may not be nested inside another pri par. 

5.1.7 Single processor programs 

In the D705B toolset, single processor programs could have bootstraps added 
by a tool called iboot, without requiring configuration. The equivalent tool in 
this toolset is icollect, with a T option. Unlike iboot, it enforces the njle 
that the server channeEs must be CHAN OF SP. 

5.1.8 Usage checking rules 

The implementation of usage checking has changed sHghtly in this release of 
the Occam compiler. In particular it enforces the rule that: for a channel array 
passed into a procedure, all channels must be used in the same direction. Usage 
checking can still be disabled if absolutely necessary. 



5.2 Changes in libraries 

This section lists the changes and bug fixes to the libraries of the Occam 2 
toolset since the D705B and equivalents. This section is in the form of a set of 
technical notes on the changes to the library implementations. 
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5.2.1 Compiler libraries 

General: It has been enforced that no routine uses vector space. 

General; There used to be a number of entry points that were not doojinented 
for use, but which were used by the compiler. These entry points were actually 
callable in user's source code. All such entry points have either been removed 
completely or given illegal OCCam identifiers so as not to be legally callable. 

FLOATING, UNPACK and DFLOATING. UNPACK for T2 and TA: arguments of 
infinities, NaNs and zeroes used not to cause any error - fixed so that they 

CAUSEERROR. 

UNPACKSN for any 32-bit transputer now exists, whereas it was previously only 
available for TB. 

ROUNDSN for any 32'bit transputer now exists, whereas it was previously only 
available for TB. 

FRACMUL for any 16-bit transputer now exists, whereas it was previously only 
available for 32-bit transputers. 

5.2.2 debug.lib 

This Is a new library. However it does contain the routine DEBUG, TIMER which 
has been moved here from process . lib. 

DEBUG. TIMER used to be called debug, timer and used to be available only 
for 32-bit transputers; it is now available on all transputers. Further, it used to 
terminate after one day if not explicitly stopped; now it will only terminate when 
explicitly stopped. 



5.2.3 convertlib 

General: It has been enforced that no routine uses vector space. 

REAL32TOSTRING and REAL64TOSTRING for all transputers; formatting and 
rounding have been much improved. 

5.2.4 crc.lib 

General: It has been enforced that no routine uses vector space. 
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5.2.5 hostioJib 

General: Toolset User Manual documentation much improved, especially not- 
ing the fact that a server dependent failure result for most routines is > 
spr. operation, failed rather than identically equal to it. 

so , write . string, so . write . string . nl , so . f write , string, 
and so.fwrite.string.nl for all transputers: used to be a maximum limit 
to the size of string that these routines could write - fixed so that there is no 
limit. 

so . read . echo . hex . int , so . read . echo . hex , int 64 and 

so. read. echo. any. int for all transputers: used not to accept lowercase 

hex digits - fixed, 

af . to . sp has been removed from this library. 

so . popen . read for all transputers: used to attempt to open a file the name of 
which resulted from a truncation of part of the environment string and filename 
if their concatenation was not long enough for full .name; further, angle brack- 
ets were not recognised in a directory specifier ( relevant for the VAX ) - both 
fixed. 

so , f write , hex . int 32 , so . write . hex . int 32 , 

so. read, echo. hex. int 32, so. read. echo. int 32, 

so. f write . int32 and so. write . int32 are new routines to this library. 

so. f write. int, so. write. int, so. f write. int €4 

and so-write.int64 used to accept negative field widths as equivalent to 

zero - fixed so that a negative field width is an error. 

so .multiplexor and so. overlapped. multiplexor have been 

renamed as so, pri, multiplexor and 

so. over lapped, pri, multiplexor, respectively. Further, it is now valid 

for SIZE <iueue in the latter to be zero, in which case input is waited for on 

stopper. 

so. multiplexor and so. overlapped. multiplexor have been re- 
placed by new, similar, routines. The old versions of these routines (see above) 
were not fair multiplexors; the new versions attempt to show some degree of 

fairness. 
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5.2.6 snglmath.lib 

General: It has been enforced that no routine uses vector space. 

POWER for T2: the size of the domain before infinity is returned has been slightly 
extended - change. 

5.2.7 dblmath.lib 

General: It has been enforced that no routine uses vector space. 

DPOWER for afl transputers: the size of the domain before infinity is returned has 
been slightly extended - change. 

5.2.8 tbmaths.lib 

General: It has been enforced that no routine uses vector space. 

General: There used to be a number of entry points that were not documented 
for use» but which were, and still are, used as support by the major routines 
of this library. These entry points were actually callable in user's source code. 
AJI such entry points have been given illegal OCCam identifiers so as not to be 
legally callable. 

5.2.9 process.tib 

debug. timer has been moved from this library into debug. lib and has 
been renamed as debug. timer. 

As this library now only contains evaluation board support processes, which are 
useful only to a minority o( customers^ il has been removed from the this release. 
The source code for the processes is included in the \d7205\examples\oc 
directory, for those customers still requiring this software. 

5.2.10 streannio.llb 

ss, write. int and ss. write. hex. int for all transputers: used to only 
allow up to 15/10 characters, respectively, to be written out - fixed to allow 
unlimited field widths. 

ss, write. int 64 and ss .write. hex. int 64 for all transputers: used to 
only allow up to 32/20 characters, respectively, to be written out - fixed to allow 
unlimited field widths. 
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ss. write. re3i32 for ali transputers: used to write out up to 40 characters 
-changed to allow no more than 24, 

S3. write. real64 for all trar^sputers: used to write out up to 60 characters 
-changed to allow no more than 30. 

ss .scrst ream. to. array for all transputers: used not to store all of the 
string into the array on receipt of the st . out . string tag - fixed. 

so.keystream.from.kbd for all transputers: used to accept negative val- 
ues for ticks .per .poll - fixed so that negative values are an error. 

so . keystream. from, file for all transputers: used to always return > 
spr. operation, failed on reaching the end of file -fixed. 

so .keystream. from, stdin for alE transputers: used to return > 
spr. operation. failed on reading the end of file from the keyboard - 
fixed. 

ss. write, int and ss .write. int 64 for all transputers: used to accept 
negative values for a field width as equivalent to zero - fixed so that negative 
values for the field width is an error, 

ss ,scrstream. multiplexor is a new routine to this library. 



5.2.11 string.llb 

General: Jt has been enforced that no routine uses vector space. 

5.2.12 xlink.nb 

General: It has been enforced that no routine uses vector space. 
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A Distribution kit 



This appendix lists the files which make up the distribution kit for this version of 
the Occam 2 toolset. Each filename is accompanied by a short description of 
the file's function. 



A.1 Directory \d7205\itools 

This directory contains the transputer-hosted tooJs. 



oc.btl 
oc.exe 
ilinlc.btl 
ilink . exe 
ilibr.btl 
illbr.exe 
icollect .btl 
icollect.exe 
ilist.btl 
ilist .exe 
occonf .btl 
occonf.exe 
idebug.btl 
idebug , exe 
ieprom.btl 
lepr om . exe 
isim.btl 
isim.exe 
icvemit .btl 
icvemit .exe 
i emit .btl 
iemit , exe 
imakef .btl 
imakef . exe 
idump.btl 
idump . exe 



Occam compiler transputer-bootable code 

Occam compiler driver program 

linker code 

linker driver program 

librarian code 

librarian driver program 

collector code 

collector driver program 

lister code 

lister driver program 

configurer code 

configurer driver program 

debugger code 

debugger driver program 

EPROM file constructor code 

EPROM file constructor driver program 

simulator code 

simulator driver program 

memory description format converter code 

memory description format converter driver program 

external memory interface program code 

external memory interface program driver program 

makefile generator code 

makefile generator driver program 

core dumper code 

core dumper driver program 
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iskip.btl skip loader code 

iskip.exe skip loader driver program 

icvlinlcbtl link format converter code 

icvlink , exe link format converter driver program 

A.2 Directory \d7205\tools 
This directory contains the PC-hosted tools. 

icollect.exe collector PC executable 

icvemit ,ex© memory description format converter PC executable 

icvlin3c.exe link format converter PC executable 

iemit.exe external memory interface program PC executable 

ieprom.exe EPROM file constructor PC executable 

ilibr.exe librarian PC executable 

ilink.exe linker PC executable 

ilist.exe lister PC executable 

imakef.exe makefile generator PC executable 



A.3 Directory \d7205\iibs 

This directory contains the libraries and include files. 



callc.lib 
convert .lib 

crc-lib 

dblmath.lib 
debug. lib 

hostio.inc 
hostio . lib 
hostio.liu 

linkaddr.inc 
linkboot -lib 



calling C from Occam library 

string conversion library 
CRC library 

64-bit arithmetic library 
debug procedure library 

host i/o library header fife 

host i/o library 

host i/o library usage file 

link address include file 
link booting library 
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mathvals.inc 
msdos . inc 
msdos.lib 

occam2 . lib 
occamS . lib 
occama . lib 
occamutl^lib 
occain2 . Ink 
occamS . Ink 
Oceania . Ink 
occonfio.lib 



maths value definitions 
MSDOS library include file 
MSDOS library 

Occam compiler library for T2 

OCCarn compiler library for T8 

Occam compiler library for TA, TB and T5 

Occam compiler utilities library 

linker file for using OCCam library for T2 

linker file for using occam library for T8 

linker file for using OCCam library for TA, TB and T5 

configurer i/o library 



romboot . lib boot from ROM library 



snglmath.lib 
strsamio.inc 
streamio.lib 
streamio * liu 
string, lib 
string, liu 
sysproc . lib 

tbmaths . lib 
ticks. inc 



32-bit arithmetic library 

stream i/o include file 

stream i/o conversion library 

stream \Jo conversion library usage file 

string handling library 

string handling library usage file 

system library 

TB maths library 

transputer clock tick rate include file 



virtual . lib OCCam compiler i/o library 
xlink.lib extraordinary link handling library 
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A.4 Directoi7 \d7205\iterms 

bansi. sys screen device driver 

pcansi , itm (TERM file for use with ANSl.SYS 

pcbansi.itm ITERIVI file for use with BANSI.SYS 

necansi.itm ITERiVl file for use witli an NEC PC 

ansi . itm ITERM file for use with a standard ANSI terminal 

readme, txt information file 

A-5 Directory \d7205\exaiiiples\bootstrp 

This directory contains source files of example bootstraps. 

A,6 Directory \d7205\exainples\idebug 

This directory contains the example sources for using the debugger. 

A.7 Directory \d7205\exainples\mixed 

This directory contains examples of mixed language programming. 

A.8 Directory \d7205\examples\niixGonf 

This directory contains examples of mixed language configuration. 

A.9 Directory \d7205\examples\oc 

This directory contains examples of using the OCCam compiler. 

A.10 Directory \d7205\exaniples\occonf 
This directory contains examples of using the configurer. 

A.11 Directory \d7205\exainples\sorter 

This directory contains the source of the sorter example progranfi. 
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AJ2 Directory \d7205\iserver 

isvrb04 .exe host file server and loader program (IBM PC version 

for B004) 
isvrboa .exe host file server and loader program (IBM PC version 

for BOOS) 
isvrnec ,exe host file server and loader program (NEC PC version) 

iserver.exe the server which was selected at installation time 



A.13 Directory \d7205\source\iserver 

Contains the sources for the host file server 

A-14 Directory \d7205\source\imakef 

Contains the sources for the makefile generator. 

A.15 Directory \d7205\source\driver 

Contains the source of the driver program. 

A.16 Directory \d7205\source\libs\convert 

Contains the source of the convert library. 

A.I 7 Directory \d7205\source\libs\hostio 
Contains the source of the hostio library, 

A-18 Directory \d7205\source\libs\maths 

Contains the source of the maths libraries. 

A.19 Directory \d7205\source\libs\msdos 

Contains the source of the msdos library, 
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A.20 Directory \d7205\sotirce\libs\streamio 
Contains the source of the streamio library, 

A,21 Directory \d7205\source\libs\string 
Contains the source of the string library. 

A,22 Directory \d7205\tdstools\itools 

idirect ,btl directive converter code 

idirect ,exe directive converter driver program 

if lat .btl TDS to toolset converter code 

if lat . exe TDS to toolset converter driver program 

if list .btl TDS lister code 

iflist.exe TDS lister driver program 

A.23 Directory \d7205\tdstools\tools 

if lat . Gxe PC-hosted TDS to toolset converter 

if list . exe PC-hostsd TDS lister 

A.24 Directory \d7205\tdstoois\iibs 

streamco-lib stream conversion library 
streamco . liu stream conversion library usage file 

A.25 Directory \d7205\tdstools\set 

clist . set driver fj[e for the if list program 

null . set driver file for the if list program 

Occam, set driver file for the if list program 

trans . idi driver file for the idirect program 

A.26 Directory \d7205\tdstools\streamco 

Contains source of the TDS to toolset stream conversion library. 
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A,27 Directory \d7205\f\itoois 

f .btl folding editor code 

f . exe folding editor driver program 

necf .bat NEC PC editor batch file 



A.28 Directory \d7205\f\tools 



f.exe 

necf . bat 



PC-hosted folding editor 
NEC PC editor batch file 



A,29 Directory \d7205\f\data 



bansi.sys 
fold . cmd 
fold,stp 
f tutor . occ 
ascii .itm 
ascii.hlp 
read . me 
pcfold, itm 
necf old, itm 
pcfold,hlp 
necf old. hip 
necini25 .lis 
tds3keys .Id 
tds3keys,tbl 
doskeys . Id 
doskeys .tbl 



screen device driver 

editor command file 

editor startup tile 

editor tutor 

ITERM for ASCII keyboard 

keyboard help file for ASCII keyboard 

information file 

ITERM file for PC terminal 

ITERM file for NEC terminal 

keyboard help file for PC terminal 

keyboard help file for NEC terminal 

NEC initialisation file 

editor keyboard setup file 

editor keyboard setup table 

keyboard reset file 

keyboard reset table 



A.30 Directory \d7205\install 

Contains source files associated with installing this release. 
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B Debugger function 
keys 



This appendix gives the keyboard assignments for the debugger symbolic tunc- 
tions for both the IBM PC and compatibles (pcansi . itm and pcbansi . itm), 
and the NEC PC (necpc. ITM). Some of the keys are applicable to the simulator 
as well. 



B,1 IBM PC LH-keypad 





F1 


F2 


Ctrl 






Shift 






Alt 




Cent [ram 




Help 




Ctrl 






Stiift 
Alt 




Chanje^le 








Ctrl 




Toggle Break 


Shift 


Search 




Wt 


Toggle Hex 






Get Address 


Goto Line 


Ctrl 






Shift 


-*- Word 


Word -*- 


Ait 


Delete Line 






-*- Line 


Line -^ 


Ctri 






Shift 


Top Of File 


End Of File 


Art 


Page Up 


Page Down 




Line Up 


Line Down 



F9 



F10 
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B.2 IBM PC main keyboard 



Esc ^ F1 

Ctrl 

Shift 

Alt 



Refresh 



F3 



F4 

















ChHj^g* FilB 




Cent From 






Help 











F5 


F6 


F7 


F8 


Ctri 




ToBBto &«fc 






Shift 


Search 




-* Word 


Ward *- 


Alt 


ToggbNsi 




Delete Une 






Q«AddK»» 


Goto Une ■< u™ 


Line *- 





Alt 


1 




3 


3 


4 


S 




6 






7 




« 




9 






Inspect 


ChgnnBJ 


Top 


Retrace 


Relocate 


Info 


Ktodtfy 


Resume 


Iwloniior 




Select 
Parameter 


Q 


W 


E 


R 


T* 

Top Of 
File 


Y 


Delete 
Une 


1 


O 


A* 
Intemipt 


S 


D 


=• 

Word 


2* 
Word 


H 


J 


K 


L 






Z 


Delete 
Une 


C 


V 


End Of 
File 


N 


M 






— 













» Ctrl + key 
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F10 







Top Of File 
"page Up "' 


End Of File 
Page Down 


Line Up 


Une Down 



Shiift 
Alt 



Alt 



Bacl^paca 



Backtrace 



Delete 
Character 



Flelurn 
Enter 



Ctrl 



Refresh 








Enter File 


* 


Exir File 




- 




^ 


Finish 


t 
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B.3 NEC PC keyboard layout 



Ft 


F2 


F3 


F4 


F5 













F6 



Esc Bzc 



Ctr1 + 

Esc + 
Key 

Clr1 + 

Esc + 
Key 

Cti1 + 

Esc + 
Key 





Inspect 


Channel 


Tdp 


Ratraco 


ReJocate 


Info 


Modify 


Resume 


Monjior 






Q 


W 
Ftefresh 


End of 


R 


T 


Y 


U 


Inspect 









'"Paga"" 


" Delete" ' 




" Toggle" " 




^UoeDp- 




-WbFd- 






Down 


Lins 




Hex 








Left 








A 


i 


3 




G 


H 


J 


K 


L 






Start of 






Search 


Goto 




Cursor 


Cursor 


Cursor 


Ctrl 




Address 




Down 


■Ch"ang& " 
Filfi 


.S^.. 


""Flilp" 


_X?&ffQ_, 


__U&-_ 


_BiflSU. 

cursor 

Lnft 




Enter 


><E,i> 


C 


' ^0,3. 


N 


M 


< 


> 


Shift 


..fijft.- 


-tF^Sb- 


Contnue" 
Rom 


" Page Tjp" ~ 


■ 




' "Top of ■ 
File 


YhSoC 
File 
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F7 



F3 



F9 



FIO 



Esc 





















Badttpoc* 


Backtrace 








Daleie 
Char 




P 

Right 








=letum 
Enter 


















Shift 













Roll Up 




Roll Down 


























t 






-* 








1 
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Snmos 



Worldwide Headquarters 

INMOS Limited 
IQQO Aztec West 
AEmondsbury 
Bristol BS12 4SQ 
UNITED KINGDOM 
Tefephone (0454) 616616 
Fax (0454) 617910 



WorJdwIda BualnAss Centres 



USA 



EUROPE 



INMOS Business Centre 
SGS-THOMSOW IWicroetectroniqs Inc. 
2225 Executive Circle 
PO Box 16000 
C dorado Springs 
Coiorado 80935-6000 
Telephone (719) 630 4000 
Fax (719) 630 4325 



SGS-THOMSOM MidrOelBcltonjcs Inc. 

Sales and Marketing Headquarters (USA) 

1000 East Bell Road 

Phoenix 

Arizona 85022 

Telephone (602) 867 6100 

Fax (602) 867 6102 



INMOS Business Centre 

SGS^THOVISON Microelectronics Inc. 

Lincoln Ncrth 

55 Old Bedford Road 

Lincoln 

Massachusetts 01773 

Tolephone (617) 259 0300 

Fax (617) 259 4420 



INMOS Bisine^ Centre 

SGS-THOMSON MLeroeiectrqnics Inc. 

9861 Broken Land Parkway 

Suite 320 

Columbia 

Maryland 21045 

Telephone (301) 995 6952 

Fax (301) 290 7047 



INMOS Business Centre 

SGS" THOMSON Microelectronics Inc. 

200 East Sandpointe 

Suite 550 

Santa Ana 

Caiifornia 92707 

Telephone (714) 957 6018 

Fax (714) 357 3281 



INMCS Business Centre 
SGS-THOMSON Wicroelectronics Inc 
2055 Gateway PJace 
Suite 300 
San Jase 
Caiifornia 95!10 
Telephone (408) 452 9122 
Fax (408) 452 021 8 



INMOS Susiness Centre 

SGS-THOMSON Microelectronics Inc. 

1310 Electronics Drive 

Carrollton 

Texas 75006 

Telephone (214)466 6844 

Fax (214) 466 7352 



ASIA PACIFIC 

Japan 

ir^MOS Business Centre 

SGS-THOMSON Micfoelecifonics K.K. 

Ni&seki Takanawa Building, 4th Floor 

18-10 Takanawa 2 chome 

Minato Ku 

Tokyo 108 

Telephone (03) 3280 4125 

Fax (03) 3280 4131 

Singapore 

INMOS Business Centre 
SGS-THOMSO^t Micfoe!ectronics Pte Ud. 
28 Ang (Vb Kio Industrial ParK 2 
Singapore 2056 
Telephone (66)482 14 11 
Fax (65} 482 02 40 



Un[ted Kingdom 

INMOS Business Centre 

SGS-THOMSON Microelectronics Ltd. 

Planar House 

Padiway GJobe Park 

Marlow 

Bucks SL7 1 YL 

Telephone (0628) 890 800 

Fax (0626) 690 391 



France 

INMOS Bu£ines& Centre 

SGS-THOMSON Micfosledronics SA 

7 Avenue Gallieni 

BP93 

94253 Gentilty Cedex 

Telephone {1)47 40 75 75 

FAX (1) 47 40 79 10 



West G*rmsny 

INMOS Business Centre 
SGS-THOMSON Microelectronics GmbH 
Bretonischsr Ring 4 
eoi 1 Grasbrunn 
Telephone (089) 46 00 GO 
Fax (089) 46 00 &-i 40 



Italy 

INMOS Business Centre 

SGS-THOMSON Microelectronics SpA 

V.ls Milanotlori 

Strada4 

Palazzo A/4/A 

20090 Assaga (Mi) 

Telephone (2) 89213 1 

Fax (2) 6250449 



